home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 3 / AGA Experience Volume 3 (1997)(NFA - SAdENESS)[!].iso / amiga / mpegplay201bin.lha / mpeg / mpeg_play.man < prev    next >
Text File  |  1993-02-09  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  5.  
  6.  
  7. NAME
  8.        mpeg_play - plays mpeg­1 encoded bitstreams using X11
  9.  
  10. SYNOPSIS
  11.        mpeg_play  [ ­nob ] [ ­nop ] [ [ ­display display_name ] [
  12.        ­dither  dither_option  ]  [  ­loop  ]  [  ­eachstat  ]  [
  13.        ­no_display  ] [ ­shmem_off ] [ ­l_range num ] [ ­cr_range
  14.        num ] [ ­cb_range num ] [ ­quiet ] file_name
  15.  
  16. DESCRIPTION
  17.        mpeg_play decodes and displays mpeg­1  encoded  bitstreams
  18.        on systems running X11.  The player will create a new win­
  19.        dow, display the bitstream, and exit.  Any error  messages
  20.        or notices are sent to stderr.
  21.  
  22. OPTIONS
  23.        ­nob  :  causes the player to ignore and not display any B
  24.               frames.
  25.  
  26.        ­nop : causes the player to ignore and not display  any  P
  27.               frames.
  28.  
  29.        ­display display_name : causes the player to open the win­
  30.               dow on the display display_name.
  31.  
  32.        ­dither dither_option : selects from a variety  of  dither
  33.               options. The possible values are:
  34.  
  35.               ordered ­ ordered dither.
  36.  
  37.               ordered2  ­  a  faster  ordered dither. This is the
  38.                      default.
  39.  
  40.               mbordered ­ ordered  dithering  at  the  macroblock
  41.                      level.   Although   there  is  a  noticeable
  42.                      decrease in  dither  quality,  this  is  the
  43.                      fastest dither available.
  44.  
  45.               fs4 ­ Floyd­Steinberg dithering with 4 error values
  46.                      propogated.
  47.  
  48.               fs2 ­ Floyd­Steinberg dithering with 2 error values
  49.                      propogated.
  50.  
  51.               fs2fast  ­  Fast  Floyd­Steinberg  dithering with 2
  52.                      error values propogated.
  53.  
  54.               hybrid ­ Hybrid dithering, a combination of ordered
  55.                      dithering  for  the  luminance  channel  and
  56.                      Floyd­Steinberg 2 error  dithering  for  the
  57.                      chrominance  channels.  Errors  are NOT pro­
  58.                      pogated  properly  and   are   dropped   all
  59.                      togethor  every  two pixels in either direc­
  60.                      tion.
  61.  
  62.  
  63.  
  64.                          27 January 1993                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  71.  
  72.  
  73.               hybrid2 ­ Hybrid dithering as above, but with error
  74.                      propogation among pixels.
  75.  
  76.               2x2  ­ A dithering technique using a 2x2 pixel area
  77.                      for each pixel. The  image  displayed  is  4
  78.                      times   larger   than   the  original  image
  79.                      encoded. Random error  terms  are  added  to
  80.                      each  pixel  to break up contours and gradi­
  81.                      ents.
  82.  
  83.               gray ­ Grayscale dithering. The image  is  dithered
  84.                      into 128 grayscales. Chrominance information
  85.                      is thrown away.
  86.  
  87.               color ­ Full color display (only  available  on  24
  88.                      bit color displays).
  89.  
  90.               none ­ no dithering is done, no image is displayed.
  91.                      Used to time decoding process.
  92.  
  93.               mono ­  Floyd­Steinberg  dithering  for  monochrome
  94.                      displays.
  95.  
  96.               threshold  ­  Floyd­simple dithering for monochrome
  97.                      displays.
  98.  
  99.        ­loop : makes the player loop back to the beginning  after
  100.               reaching the end.
  101.  
  102.        ­quiet  :  supresses  printing  of  frame  numbers, timing
  103.               information, and most error messages.
  104.  
  105.        ­eachstat : causes statistics to be displayed  after  each
  106.               frame. Only valid when compiled with ­DANALYSIS.
  107.  
  108.        ­shmem_off : turns shared memory off.
  109.  
  110.        ­l_range  num_colors  : sets the number of colors assigned
  111.               to  the  luminance  component  when  dithering  the
  112.               image.    The  product  of  l_range,  cr_range  and
  113.               cb_range should be less than the number  of  colors
  114.               on the display.
  115.  
  116.        ­cr_range  num_colors : sets the number of colors assigned
  117.               to the red component of the chrominace  range  when
  118.               dithering  the  image.   The  product  of  l_range,
  119.               cr_range and cb_range should be less than the  num­
  120.               ber of colors on the display.
  121.  
  122.        ­cb_range  num_colors : sets the number of colors assigned
  123.               to the blue component of the chrominace range  when
  124.               dithering  the  image.   The  product  of  l_range,
  125.               cr_range and cb_range should be less than the  num­
  126.               ber of colors on the display.
  127.  
  128.  
  129.  
  130.                          27 January 1993                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  137.  
  138.  
  139.        ­no_display  : dithers, but does not display, usually used
  140.               for testing and timing purposes.
  141.  
  142. NOTES
  143.        The player expects MPEG­1 video streams only. It  can  not
  144.        handle  multiplexed  MPEG  streams or video+audio streams.
  145.        The player uses the paris entropy coding table set  (which
  146.        we  believe to be the MPEG­1 standard), but can not handle
  147.        any bitstreams that use the "berlin" entropy coding  table
  148.        set.  Berlin data is relatively rare so there shouldn't be
  149.        too much to worry about here, but be aware of the  differ­
  150.        ence when looking for streams to play.
  151.  
  152.        Some  streams do not end with the proper sequence end code
  153.        and will  probably  generate  an  "Improper  sequence  end
  154.        code." error when done playing.
  155.  
  156.        This  player  can play XING data files. Be aware that XING
  157.        makes no use  of  temporal  redundancy  or  motion  vector
  158.        information.  In  other  words, they do not use any P or B
  159.        frames in their streams. Instead, XING data  is  simply  a
  160.        sequence  of  I  frames. Since I frames take significantly
  161.        longer to decode, performance of  the  player  using  XING
  162.        data is not representative of the player's ability.
  163.  
  164. AUTHORS
  165.        Ketan  Patel  ­  University  of California, Berkeley, kpa­
  166.               tel@cs.berkeley.edu
  167.  
  168.        Brian  Smith  ­  University   of   California,   Berkeley,
  169.               bsmith@cs.berkeley.edu
  170.  
  171.        Henry  Chi­To  Ma  ­  University  of California, Berkeley,
  172.               cma@cs.berkeley.edu
  173.  
  174.        Kim  Man  Liu  ­  University  of   California,   Berkeley,
  175.               kliu@cs.berkeley.edu
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                          27 January 1993                        3
  197.  
  198.  
  199.